home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / CDROM / cdid2asim / README < prev    next >
Text File  |  1997-09-24  |  9KB  |  242 lines
  1. Short:    apply CDID-file on AsimCDFS-CDDA
  2. Version:  1.4
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Author:   Thomas Aglassinger <agi@giga.or.at>
  5. Type:     disk/cdrom
  6. Kurz:     CDID-Datei auf AsimCDFS-CDDA anwenden
  7. Requires: AsimCDFS 3.5, AmigaOS 2.x
  8.  
  9. TITLE
  10.  
  11.   cdid2asim
  12.  
  13. VERSION
  14.  
  15.   1.4
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   Transfers an already existing CDID-file to an Audio-CD (CDDA):
  24.   relabels the disk and renames the tracks using the information
  25.   found in the CDID-file.
  26.  
  27. SPECIAL REQUIREMENTS
  28.  
  29.   AsimCDFS 3.5, SCSI-CD-Rom with support for Audio-CDs, AmigaOS 2.x.
  30.   and CDID-files (which can be created and modified by several
  31.   CDDA-Players, like MCDPlayer and OptyCDPlayer).
  32.  
  33.   It also might work with older versions of AsimCDFS, but I didn't
  34.   test this.
  35.  
  36. AVAILABILITY
  37.  
  38.   Every Aminet-mirror, file "disk/cdrom/cdid2asim.lha"; for example
  39.   "ftp://ftp.wustl.edu/pub/aminet/disk/cdrom/cdid2asim.lha".
  40.  
  41. PRICE
  42.  
  43.   Freeware.
  44.  
  45. DISTRIBUTABILITY
  46.  
  47.   Cdid2asim is copyrighted freeware. It may be distributed freely as
  48.   long as no modifications are made to the executable and this
  49.   document. A nominal fee may be asked to cover distribution costs.
  50.  
  51.   Cdid2asim may not be used for any commercial purposes or included
  52.   with any commercial product without the written permission of the
  53.   author.
  54.  
  55. MOTIVATION
  56.  
  57.   AsimCDFS supports CDDAs is quite nifty way: You can access every
  58.   track immediately as file. By default, they are named like "Track.1",
  59.   "Track.2" and so on. These names can be changed (from Workbench or
  60.   using AsimTunes), but this is a rather dull task.
  61.  
  62.   There already exists a large pool of CDID-files (for example,
  63.   aminet:disk/cdrom/CDIDCollection.lha), but unfortunately, no
  64.   converter is included with AsimCDFS.
  65.  
  66. INSTALLATION
  67.  
  68.   Drag the icon anywhere you want and modify the tooltypes to fit your
  69.   needs.
  70.  
  71.   If you want to use it from CLI, make sure that stack has been set
  72.   to at least 16 KB (enter "stack 16384" in CLI).
  73.  
  74. TEMPLATE
  75.  
  76.   CDIDPATH/K,TRACKPATH/K,NOTITLE/S,NOTRACKS/S,NOBLANKS/S,
  77.   RESET/S,VERBOSE/S
  78.  
  79. USAGE
  80.  
  81.   Cdid2asim can be invoked from CLI or Workbench. The arguments
  82.   for the tooltypes are the same as for CLI.
  83.  
  84.   CDIDPATH   directory, where the CDID-files ("ID#?") are located
  85.   TRACKPATH  directory, where the "Track.#?"-files are located.
  86.              default "CD0:AIFF_Stereo"; usually, there should be no
  87.              need to change this.
  88.              NOTE: Renaming a file in one of the directories for 
  89.              different audio-formats also affects all corresponding 
  90.              files in all other directories.
  91.   NOTITLE    do not relabel disk with album-title
  92.   NOTRACKS   do not rename files with track-title
  93.   NOBLANKS   replace blanks in titles by underscores ("_")
  94.   RESET      reset title and/or tracks to defaults ("Title_Unknown"
  95.              and "Track.#?")
  96.   VERBOSE    enable verbose output
  97.  
  98.   The required CDID-file needs already to exist, and, of course,
  99.   the CDDA you want to apply the CDID-file on needs to be inserted
  100.   in your CD-ROM-drive.
  101.  
  102.   Cdid2asim does some manipulation on the original title when
  103.   converting it to a filename:
  104.   - surrounding blanks are removed
  105.   - text inside brackets is removed
  106.   - some special characters ("#?|~..") are replaced by "-"
  107.   - "/" is replaced by "\"
  108.  
  109.   If the filename is still too long, it will be cut down to the
  110.   filesystem-maximum (30 characters for the album-title, 25 characters
  111.   for track-titles) and the last two characters will be "..".
  112.  
  113.   If several tracks exist with the same name or tracks don't result
  114.   in unique filenames after 25 characters, an unique filename will
  115.   be computed (extensions like ".1", ".2".. are appended).
  116.  
  117.   Of course, the original CDID-file remains unchanged during the
  118.   whole process.
  119.  
  120. EXAMPLE
  121.  
  122.   CDID-file: ID100081EC029E71
  123.     ("[xyz]" denotes comments which are not part of the CDID-file)
  124.  
  125.     Half Man Half Biscuit                        [artist]
  126.     Mc Intyre, Treadmore And Davitt              [title]
  127.     Outbreak Of Vitas Gerulaitis                 [track#1]
  128.     Prag Vec At The Melkweg                      [track#2]
  129.     Christian Rock Concert                       [track#3]
  130.     Lets Not                                     [track#4]
  131.     Yipps (My Baby Got The)                      [track#5]
  132.     Hedley Verityesque                           [track#6]
  133.     A Lilac Harry Quinn                          [track#7]
  134.     Our Tune                                     [track#8]
  135.     Girlfriend's Finished With Him               [track#9]
  136.     Everything's A.O.R.                          [track#10]
  137.  
  138.   Command call (for my machine):
  139.  
  140.     cdid2asim CDIDPATH=appl:sound/disks VERBOSE
  141.  
  142.   Program output:
  143.  
  144.     cdid2asim - apply CDID-file on AsimCDFS-CDDA (v1.4, 24.09.97)
  145.     (C) Thomas Aglassinger 1996,1997 - This is Freeware!
  146.     Rename `CD0:' to `Mc Intyre, Treadmore And..'
  147.     Rename `Track.1' to `Outbreak Of Vitas..'
  148.     Rename `Track.2' to `Prag Vec At The Melkweg'
  149.     Rename `Track.3' to `Christian Rock Concert'
  150.     Rename `Track.4' to `Lets Not'
  151.     Rename `Track.5' to `Yipps'
  152.     Rename `Track.6' to `Hedley Verityesque'
  153.     Rename `Track.7' to `A Lilac Harry Quinn'
  154.     Rename `Track.8' to `Our Tune'
  155.     Rename `Track.9' to `Girlfriend's Finished..'
  156.     Rename `Track.10' to `Everything's A.O.R.'
  157.     10 out of 10 track-titles modified
  158.  
  159.   Comments:
  160.  
  161.     For the title, "Mc Intyre, Treadmore And Davitt", the text is
  162.     reduced to fit 30 characters and ends with ".."
  163.     For track#1, "Outbreak Of Vitas Gerulaitis", the text is reduced
  164.     to fit 25 characters and ends with "..". This still allows a
  165.     ".info" to be appended to the filename.
  166.     For track#5, "Yipps (My Baby Got The)", the text inside brackets
  167.     is removed and results in "Yipps".
  168.  
  169. PROBLEMS
  170.  
  171.   - If CLI-Version crashes, make sure that a stack of at least 16 KB 
  172.     is used (enter "stack 16384" in CLI)
  173.   - When updating the album-title (with NOTITLE not specified), 
  174.     CDDAs currently playing are interrupted. This is a feature of
  175.     AsimCDFS.
  176.   - Cdid2asim asumes that Examine() and ExNext() return the
  177.     track-sequence in correct order. This is the case for version
  178.     3.x of AsimCDFS, but if this changes in future, the filenames
  179.     won't fit the corresponding tracks anymore.
  180.   - As a feature of AsimCDFS, the usage of cdid2asim also affects
  181.     the database used by AsimTunes, but the artist-field remains
  182.     untouched.
  183.  
  184.   If, for some reason, the filenames get totally trashed, you
  185.   can repair them using the editor of AsimTunes. I needed this
  186.   once during development, when two files got identical names
  187.   (of course, this bug has already been fixed).
  188.  
  189. DISCLAIMER
  190.  
  191.   No responsibilities are taken for damaged CDs, CDROM drives, Amigas
  192.   or any other components or data involved while using cdid2asim.
  193.  
  194.   If you find any bugs, let me know.
  195.  
  196. CREDITS
  197.  
  198.   Thanks to Boris Jakubaschk for MCDPlayer; most of the SCSI-stuff
  199.   is based on his sources.
  200.  
  201. HISTORY
  202.  
  203.   Version 1.4, 25-Sep-1997
  204.   - characters with an ASCII-code greater than 128 are now treated
  205.     like alphanumeric characters; for instance J.Karjalainen's
  206.     "Rockin' Kyöstin rokkibändi" now results in "Rockin' Kyöstin.."
  207.     instead of "Rockin' Kyöstin rokkibä.."
  208.   - now CD-title only is updated if necessary
  209.  
  210.   Version 1.3, 21-May-1997
  211.   - no more SCSI device and unit necessary, as this information
  212.     is now obtained from the device name (usually CD0:)
  213.   - removed CLI options DEVICE and UNIT (as a result of the above)
  214.   - check, if CD drive is handled by AsimCDFS, is now performed in a
  215.     better way (scans OS-data structures instead just checks for
  216.     existence of l:AsimCDFS)
  217.   - fixed some inconsistencies in this README.
  218.  
  219.   Version 1.2, 16-May-1997
  220.   - renamed from "DiskID2Asim" to "cdid2asim"
  221.   - increased stack to 16 KB (WB-Version could crash with smaller 
  222.     stack)
  223.   - improved track name conversion:
  224.     - non-alphanumeric characters (except "." and "!") at end of
  225.       track names are removed
  226.     - blanks before the ".." at the end of long filenames are
  227.       removed
  228.     - double blanks are converted to a single one
  229.   - renamed option DISKIDPATH to CDIDPATH
  230.  
  231.   Version 1.1, 3-Sep-1996
  232.   - uses more sophisticated algorithm to create unique filenames
  233.   - no more insists on tracks named "Track.#?" and therefor
  234.     can be applied multiple times (if the DiskID-file has been
  235.     modified)
  236.   - removes only whole words from long names
  237.   - checks if "l:AsimCDFS" is available
  238.   - added RESET option
  239.  
  240.   Version 1.0, 2-Sep-1996
  241.   - initial release
  242.